﻿//
// Copyright (c) 2011 David Díaz & Fran Pedreira
//
// This file is part of PlanSim.
//
// PlanSim is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// PlanSim is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with PlanSim. If not, see <http://www.gnu.org/licenses/>.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace PlanSim.Core
{
    public interface ICola
    {
		/// <summary>
		/// Identificador de la cola.
		/// </summary>
		string Nombre { get; }

		/// <summary>
		/// Prioridad de la cola.
		/// </summary>
		int Prioridad { get; }

        /// <summary>
        /// Devuelve una referencia al elemento i-esimo.
        /// </summary>
        /// <param name="i"></param>
        /// <returns></returns>
        IProceso Elemento(int i);

        /// <summary>
        /// Añade un proceso a la cola.
        /// </summary>
        /// <param name="proceso"></param>
        void Encolar(IProceso proceso);

        /// <summary>
        /// Extrae un proceso de la cola.
        /// </summary>
        /// <returns></returns>
        IProceso Desencolar();

        /// <summary>
        /// Obtiene el número de procesos que contiene la cola.
        /// </summary>
        /// <returns></returns>
        int Elementos();

        /// <summary>
        /// Indica si la cola contiene el proceso especificado.
        /// </summary>
        /// <param name="proceso"></param>
        /// <returns></returns>
        bool Contiene(IProceso proceso);

        /// <summary>
        /// Indica si, atendiendo a la estrategia de la cola, un proceso debe dejar libre la CPU.
        /// </summary>
        /// <param name="planificador"></param>
        /// <returns></returns>
        bool DebeSalirProceso(IPlanificador planificador);
    }
}
